Folders Collection Object

The Folders collection object contains one or more Folder objects.

Quick Info

A Folders collection is considered a large collection, which means that the Count and Item properties have limited validity, and your best option is to use a Folder object identifier value or the Get methods to access an individual Folder object within the collection.

Properties

Methods

Remarks

Large collections, such as the Folders collection, cannot always maintain an accurate count of the number of objects in the collection. It is strongly recommended that you use the GetFirst2M91_LL, GetNextL476GW, GetLast31_T_53, and GetPreviousICJPU4 methods to access individual items in the collection. You can also access a specific folder by using the Session object s GetFolder67IU1J method.

Example

To refer to a unique Folder object within the Folders collection, use the collection s GetFirst and GetNext methods or use the FolderID value as the index.

The following code sample demonstrates the Get methods. The sample assumes that you have three subfolders within your Inbox and three subfolders within your Outbox. After this code runs, the three folders in the Inbox are named Blue, Red, and Orange (in that order), and the three folders in the Outbox are named Gold, Purple, and Yellow (in that order).

Dim objSession As Object

Dim objMessage As Object

Dim objFolder As Object

Set objSession = CreateObject("MAPI.Session")

objSession.Logon "User", "", True

With objSession.Inbox.Folders

   Set objFolder = .GetFirst

   objFolder.Name = "Blue"

   Set objFolder = .GetNext

   objFolder.Name = "Red"

   Set objFolder = .GetLast

   objFolder.Name = "Orange"

End With

With objSession.Outbox.Folders

   Set objFolder = .GetFirst

   objFolder.Name = "Gold"

   Set objFolder = .GetNext

   objFolder.Name = "Purple"

   Set objFolder = .GetLast

   objFolder.Name = "Yellow"

End With

objSession.Logoff

See Also

Object CollectionsH0P41I